Androidでインストール時のリファラ情報を取得する
Google Playからのダウンロード・インストール時に処理をする
Androidではアプリケーションのインストール時に指定したレシーバーを動作させ、任意の処理を行うことができます。 また、URLパラメータを使用することも可能なので、リファラ情報を設定すればどこからGoogle Playへ来たのかを知ることも可能です。 今回はAndroidでリファラ情報を取得してみます。
環境構築
今回使用した動作環境は以下のとおりです。
- OS : MacOS X 10.7.4
- Eclipse : 4.2
- Android : 4.0.3
通常のAndroidプロジェクトを作成して試してみます。 今回はFile > New > Android Application Projectを選択し、プロジェクトを作成しました。
サンプルアプリケーションの作成
Google Playからのインストール時にログを出力するだけの簡単なサンプルを作成します。 まずはアプリケーションの起動時に実行されるレシーバーを作成します。
package jp.cm.receiver
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
public class RefReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
String referrer = intent.getStringExtra("referrer");
Log.d("[REFERRER]",referrer);
}
}
BroadcastReceiverを継承してレシーバーを作成します。 アプリケーションのインストール時に起動するレシーバーは、必ずreferrerパラメータを持っているので、 その値を出力しています。 次にAndroidManifest.xmlを編集します。
<receiver
android:name="jp.cm.receiver.RefReceiver"
android:exported="true" >
<intent-filter>
<action android:name="com.android.vending.INSTALL_REFERRER" >
</action>
</intent-filter>
</receiver>
receiverタグに先ほど作成したレシーバーを指定します。 intent-filterにはcom.android.vending.INSTALL_REFERRERを指定しなければいけません。 これでGoogle Playからのインストール時にRefReceiverが実行されるようになりました。
エミュレータでINSTALL_REFERRERのテスト
このレシーバーをテストするためにわざわざGoogle Playにアップロードするのは面倒なので、ローカルで動かしたいところです。 このレシーバーをエミュレータで動作させるには、adbコマンドを使用して擬似的にブロードキャストを送出します。
% adb shell am broadcast -a com.android.vending.INSTALL_REFERRER --es referrer hello
リファラ情報を付けてGoogle Playへのリンクを貼る
htmlでGoogle Play上のアプリケーションへのリンクの貼り方です。 通常のhttpから始まる形式と、Android用にスキーマ形式を使用する方法があります。
<p>referrer test1</p> <a href="http://play.google.com/store/apps/details?id=<your application package>&referrer=hello">link1</a> <p>referrer test2</p> <a href="market://details?id=<your application package>&referrer=hello">link2</a>
